home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / PROGSCAL / TPSOURCE.LZH / PFORMAT.DOC < prev    next >
Text File  |  1985-02-03  |  4KB  |  83 lines
  1.  
  2.                                    p F O R M A T
  3.                                    ~~~~~~~~~~~~~
  4.                                       rel 1.01                             
  5.                                   16 November 1984
  6.  
  7.           ________________________________________________________________
  8.                            Author:  Andy Decepida PC1171              
  9.           ----------------------------------------------------------------
  10.  
  11.           Function  :  pFORMAT  reads in an ASCII text  file,  assumed  to 
  12.                        contain   a  syntactically  correct  Turbo   Pascal 
  13.                        program   (source),   and  generates  a  copy  with 
  14.                        alterations  in  the  case  of  the  letters   that 
  15.                        comprise both the contained reserved words and non-
  16.                        reserved words as per the user's choice.
  17.  
  18.                        pFORMAT  will  NOT  (as  of  this  release)  indent 
  19.                        logical and physical blocks in a proper hierarchy.  
  20.  
  21.  
  22.           The  user is proffered several choices for the formatting of the 
  23.           output file.  These are outlined below. 
  24.  
  25.               Options available for PASCAL reserved words (including Turbo 
  26.               Intrinsics and extensions:
  27.  
  28.                   o   UPPER-CASE/Capitalize all reserved words;
  29.                   o   LOWER-CASE all reserved words; or,
  30.                   o   Keep  the reserved words in an AS-IS (read from  the 
  31.                       original file) state.
  32.  
  33.  
  34.               Options available for Turbo Pascal intrinsics and extensions 
  35.               to Pascal:
  36.  
  37.                   o   UPPER-CASE/Capitalize all intrinsics & extensions;
  38.                   o   LOWER-CASE all intrinsics and extensions;
  39.                   o   Keep  the  intrinsics  and extensions  in  an  AS-IS 
  40.                       state; or,
  41.                   o   Use   the  BORLAND  manual  type  setting   of   the 
  42.                       intrinsics and extensions (e.g., "TextColor" instead 
  43.                       or "textcolor" or "TEXTCOLOR").
  44.  
  45.  
  46.               Options  available for user-defined  identifiers  (excluding 
  47.               text  enclosed in the string delimiter [the apostrophe]  and 
  48.               text    enclosed   in   comment   delimiters   [either   the 
  49.               opening/closing    brace   or    the    parentheses-asterisk 
  50.               combination]):
  51.  
  52.                   o   UPPER-CASE;
  53.                   o   LOWER-CASE; or
  54.                   o   AS-IS.
  55.  
  56.  
  57.           REMARKS:   This is a slow program, don't expect too much from it 
  58.           in terms of speed.   However,  for what it will do for you it is 
  59.           suitable.  
  60.  
  61.                      pFORMAT  was originally written by the author in UCSD 
  62.           Pascal for the IBM implementation of the p-SYSTEM.  For those of 
  63.           you who know what that means, this is an improvement in speed as 
  64.           it is.  When & if the author manages to familiarize himself with 
  65.           BLOCKREAD & BLOCKWRITE, we'll talk more speed then.  
  66.  
  67.                      pFORMAT  can  handle strings  and  comments  properly 
  68.           (that  is,  the  program will leave them as  is!).   Single- and 
  69.           multi-line comments are both accomodated.   Hint,  hint...if you 
  70.           wish a portion of your code to be untouched by pFORMAT (say  you 
  71.           want  to visually isolate/highlight some lines) comment them out 
  72.           prior to submission to this program.
  73.  
  74.                      "pFORMAT" stands for p(retty)-FORMAT(ter.
  75.  
  76.                      Finally,  pFORMAT is being released by the author  to 
  77.           the  public  domain  via  PCCanada  and  other  BBS's.    It  is 
  78.           requested  by  the author that the ethics that have  applied  to 
  79.           other  public domain  programs/utilities be applied to  pFORMAT.  
  80.           Failing that, be guided by your conscience.
  81.  
  82.                                  andy j s decepida
  83.                                     16 Nov 1984